home *** CD-ROM | disk | FTP | other *** search
/ Windows News 2005 February / WN_129_CD.iso / Windows / Extensions Firefox / Spiderzilla / spiderzillaFr.xpi / spiderzilla / content / httrack / help.txt next >
Encoding:
Text File  |  2003-06-19  |  11.6 KB  |  217 lines
  1.  
  2. HTTrack version 3.23+swf (compiled Mar  8 2003)
  3.     usage: C:\PROGRA~1\MOZILLA.ORG\MOZILL~1\CHROME\SPIDER~1\CONTENT\HTTRACK\HTTRACK.EXE <URLs> [-option] [+<FILTERs>] [-<FILTERs>]
  4.     with options listed below: (* is the default value)
  5.  
  6. General options:
  7.   O  path for mirror/logfiles+cache (-O path_mirror[,path_cache_and_logfiles]) (--path <param>)
  8.  
  9. Action options:
  10.   w *mirror web sites (--mirror)
  11.   W  mirror web sites, semi-automatic (asks questions) (--mirror-wizard)
  12.   g  just get files (saved in the current directory) (--get-files)
  13.   i  continue an interrupted mirror using the cache (--continue)
  14.   Y   mirror ALL links located in the first level pages (mirror links) (--mirrorlinks)
  15.  
  16. Proxy options:
  17.   P  proxy use (-P proxy:port or -P user:pass@proxy:port) (--proxy <param>)
  18.  %f *use proxy for ftp (f0 don't use) (--httpproxy-ftp[=N])
  19.  
  20. Limits options:
  21.   rN set the mirror depth to N (* r9999) (--depth[=N])
  22.  %eN set the external links depth to N (* %e0) (--ext-depth[=N])
  23.   mN maximum file length for a non-html file (--max-files[=N])
  24.   mN,N2 maximum file length for non html (N) and html (N2)
  25.   MN maximum overall size that can be uploaded/scanned (--max-size[=N])
  26.   EN maximum mirror time in seconds (60=1 minute, 3600=1 hour) (--max-time[=N])
  27.   AN maximum transfer rate in bytes/seconds (1000=1KB/s max) (--max-rate[=N])
  28.  %cN maximum number of connections/seconds (*%c10) (--connection-per-second[=N])
  29.   GN pause transfer if N bytes reached, and wait until lock file is deleted (--max-pause[=N])
  30.  
  31. Flow control:
  32.   cN number of multiple connections (*c8) (--sockets[=N])
  33.   TN timeout, number of seconds after a non-responding link is shutdown (--timeout)
  34.   RN number of retries, in case of timeout or non-fatal errors (*R1) (--retries[=N])
  35.   JN traffic jam control, minimum transfert rate (bytes/seconds) tolerated for a link (--min-rate[=N])
  36.   HN host is abandonned if: 0=never, 1=timeout, 2=slow, 3=timeout or slow (--host-control[=N])
  37.  
  38. Links options:
  39.  %P *extended parsing, attempt to parse all links, even in unknown tags or Javascript (%P0 don't use) (--extended-parsing[=N])
  40.   n  get non-html files 'near' an html file (ex: an image located outside) (--near)
  41.   t  test all URLs (even forbidden ones) (--test)
  42.  %L <file> add all URL located in this text file (one URL per line) (--list <param>)
  43.  %S <file> add all scan rules located in this text file (one scan rule per line) (--urllist <param>)
  44.  
  45. Build options:
  46.   NN structure type (0 *original structure, 1+: see below) (--structure[=N])
  47.      or user defined structure (-N "%h%p/%n%q.%t")
  48.   LN long names (L1 *long names / L0 8-3 conversion / L2 ISO9660 compatible) (--long-names[=N])
  49.   KN keep original links (e.g. http://www.adr/link) (K0 *relative link, K absolute links, K4 original links, K3 absolute URI links) (--keep-links[=N])
  50.   x  replace external html links by error pages (--replace-external)
  51.  %x  do not include any password for external password protected websites (%x0 include) (--no-passwords)
  52.  %q *include query string for local files (useless, for information purpose only) (%q0 don't include) (--include-query-string)
  53.   o *generate output html file in case of error (404..) (o0 don't generate) (--generate-errors)
  54.   X *purge old files after update (X0 keep delete) (--purge-old[=N])
  55.  %p  preserve html files 'as is' (identical to '-K4 -%F ""') (--preserve)
  56.  
  57. Spider options:
  58.   bN accept cookies in cookies.txt (0=do not accept,* 1=accept) (--cookies[=N])
  59.   u  check document type if unknown (cgi,asp..) (u0 don't check, * u1 check but /, u2 check always) (--check-type[=N])
  60.   j *parse Java Classes (j0 don't parse) (--parse-java[=N])
  61.   sN follow robots.txt and meta robots tags (0=never,1=sometimes,* 2=always) (--robots[=N])
  62.  %h  force HTTP/1.0 requests (reduce update features, only for old servers or proxies) (--http-10)
  63.  %k  use keep-alive if possible, greately reducing latency for small files and test requests (%k0 don't use) (--keep-alive)
  64.  %B  tolerant requests (accept bogus responses on some servers, but not standard!) (--tolerant)
  65.  %s  update hacks: various hacks to limit re-transfers when updating (identical size, bogus response..) (--updatehack)
  66.  %A  assume that a type (cgi,asp..) is always linked with a mime type (-%A php3,cgi=text/html;dat,bin=application/x-zip) (--assume <param>)
  67.      shortcut: '--assume standard' is equivalent to -%A php2,php3,php4,php,cgi,asp,jsp,pl,cfm=text/html
  68.  @iN internet protocol (0=both ipv6+ipv4, 4=ipv4 only, 6=ipv6 only) (--protocol[=N])
  69.  
  70. Browser ID:
  71.   F  user-agent field (-F "user-agent name") (--user-agent <param>)
  72.  %F  footer string in Html code (-%F "Mirrored [from host %s [file %s [at %s]]]" (--footer <param>)
  73.  %l  preffered language (-%l "fr, en, jp, *" (--language <param>)
  74.  
  75. Log, index, cache
  76.   C  create/use a cache for updates and retries (C0 no cache,C1 cache is prioritary,* C2 test update before) (--cache[=N])
  77.   k  store all files in cache (not useful if files on disk) (--store-all-in-cache)
  78.  %n  do not re-download locally erased files (--do-not-recatch)
  79.  %v  display on screen filenames downloaded (in realtime) - * %v1 short version (--display)
  80.   Q  no log - quiet mode (--do-not-log)
  81.   q  no questions - quiet mode (--quiet)
  82.   z  log - extra infos (--extra-log)
  83.   Z  log - debug (--debug-log)
  84.   v  log on screen (--verbose)
  85.   f *log in files (--file-log)
  86.   f2 one single log file (--single-log)
  87.   I *make an index (I0 don't make) (--index)
  88.  %I  make an searchable index for this mirror (* %I0 don't make) (--search-index)
  89.  
  90. Expert options:
  91.   pN priority mode: (* p3) (--priority[=N])
  92.       p0 just scan, don't save anything (for checking links)
  93.       p1 save only html files
  94.       p2 save only non html files
  95.      *p3 save all files
  96.       p7 get html files before, then treat other files
  97.   S  stay on the same directory (--stay-on-same-dir)
  98.   D *can only go down into subdirs (--can-go-down)
  99.   U  can only go to upper directories (--can-go-up)
  100.   B  can both go up&down into the directory structure (--can-go-up-and-down)
  101.   a *stay on the same address (--stay-on-same-address)
  102.   d  stay on the same principal domain (--stay-on-same-domain)
  103.   l  stay on the same TLD (eg: .com) (--stay-on-same-tld)
  104.   e  go everywhere on the web (--go-everywhere)
  105.  %H  debug HTTP headers in logfile (--debug-headers)
  106.  
  107. Guru options: (do NOT use if possible)
  108.  #X *use optimized engine (limited memory boundary checks) (--fast-engine)
  109.  #0  filter test (-#0 '*.gif' 'www.bar.com/foo.gif') (--debug-testfilters <param>)
  110.  #C  cache list (-#C '*.com/spider*.gif' (--debug-cache <param>)
  111.  #f  always flush log files (--advanced-flushlogs)
  112.  #FN maximum number of filters (--advanced-maxfilters[=N])
  113.  #h  version info (--version)
  114.  #K  scan stdin (debug) (--debug-scanstdin)
  115.  #L  maximum number of links (-#L1000000) (--advanced-maxlinks)
  116.  #p  display ugly progress information (--advanced-progressinfo)
  117.  #P  catch URL (--catch-url)
  118.  #R  old FTP routines (debug) (--debug-oldftp)
  119.  #T  generate transfer ops. log every minutes (--debug-xfrstats)
  120.  #u  wait time (--advanced-wait)
  121.  #Z  generate transfer rate statictics every minutes (--debug-ratestats)
  122.  #!  execute a shell command (-#! "echo hello") (--exec <param>)
  123.  
  124. Command-line specific options:
  125.   V execute system command after each files ($0 is the filename: -V "rm \$0") (--userdef-cmd <param>)
  126.  %U run the engine with another id when called as root (-%U smith) (--user <param>)
  127.  
  128. Details: Option N
  129.   N0 Site-structure (default)
  130.   N1 HTML in web/, images/other files in web/images/
  131.   N2 HTML in web/HTML, images/other in web/images
  132.   N3 HTML in web/,  images/other in web/
  133.   N4 HTML in web/, images/other in web/xxx, where xxx is the file extension (all gif will be placed onto web/gif, for example)
  134.   N5 Images/other in web/xxx and HTML in web/HTML
  135.   N99 All files in web/, with random names (gadget !)
  136.   N100 Site-structure, without www.domain.xxx/
  137.   N101 Identical to N1 exept that "web" is replaced by the site's name
  138.   N102 Identical to N2 exept that "web" is replaced by the site's name
  139.   N103 Identical to N3 exept that "web" is replaced by the site's name
  140.   N104 Identical to N4 exept that "web" is replaced by the site's name
  141.   N105 Identical to N5 exept that "web" is replaced by the site's name
  142.   N199 Identical to N99 exept that "web" is replaced by the site's name
  143.   N1001 Identical to N1 exept that there is no "web" directory
  144.   N1002 Identical to N2 exept that there is no "web" directory
  145.   N1003 Identical to N3 exept that there is no "web" directory (option set for g option)
  146.   N1004 Identical to N4 exept that there is no "web" directory
  147.   N1005 Identical to N5 exept that there is no "web" directory
  148.   N1099 Identical to N99 exept that there is no "web" directory
  149. Details: User-defined option N
  150.   '%n' Name of file without file type (ex: image)
  151.   '%N' Name of file, including file type (ex: image.gif)
  152.   '%t' File type (ex: gif)
  153.   '%p' Path [without ending /] (ex: /someimages)
  154.   '%h' Host name (ex: www.someweb.com)
  155.   '%M' URL MD5 (128 bits, 32 ascii bytes)
  156.   '%Q' query string MD5 (128 bits, 32 ascii bytes)
  157.   '%q' small query string MD5 (16 bits, 4 ascii bytes)
  158.      '%s?' Short name version (ex: %sN)
  159.   '%[param]' param variable in query string
  160.   '%[param:before:after:notfound:empty]' advanced variable extraction
  161. Details: User-defined option N and advanced variable extraction
  162.    %[param:before:after:notfound:empty]
  163.    param : parameter name
  164.    before : string to prepend if the parameter was found
  165.    after : string to append if the parameter was found
  166.    notfound : string replacement if the parameter could not be found
  167.    empty : string replacement if the parameter was empty
  168.    all fields, except the first one (the parameter name), can be empty
  169.  
  170. Details: Option K
  171.   K0  foo.cgi?q=45  ->  foo4B54.html?q=45 (relative URI, default)
  172.   K                 ->  http://www.foobar.com/folder/foo.cgi?q=45 (absolute URL) (--keep-links[=N])
  173.   K4                ->  foo.cgi?q=45 (original URL)
  174.   K3                ->  /folder/foo.cgi?q=45 (absolute URI)
  175.  
  176. Shortcuts:
  177. --mirror      <URLs> *make a mirror of site(s) (default)
  178. --get         <URLs>  get the files indicated, do not seek other URLs (-qg)
  179. --list   <text file>  add all URL located in this text file (-%L)
  180. --mirrorlinks <URLs>  mirror all links in 1st level pages (-Y)
  181. --testlinks   <URLs>  test links in pages (-r1p0C0I0t)
  182. --spider      <URLs>  spider site(s), to test links: reports Errors & Warnings (-p0C0I0t)
  183. --testsite    <URLs>  identical to --spider
  184. --skeleton    <URLs>  make a mirror, but gets only html files (-p1)
  185. --update              update a mirror, without confirmation (-iC2)
  186. --continue            continue a mirror, without confirmation (-iC1)
  187.  
  188. --catchurl            create a temporary proxy to capture an URL or a form post URL
  189. --clean               erase cache & log files
  190.  
  191. --http10              force http/1.0 requests (-%h)
  192.  
  193.  
  194. example: httrack www.someweb.com/bob/
  195. means:   mirror site www.someweb.com/bob/ and only this site
  196.  
  197. example: httrack www.someweb.com/bob/ www.anothertest.com/mike/ +*.com/*.jpg
  198. means:   mirror the two sites together (with shared links) and accept any .jpg files on .com sites
  199.  
  200. example: httrack www.someweb.com/bob/bobby.html +* -r6
  201. means get all files starting from bobby.html, with 6 link-depth, and possibility of going everywhere on the web
  202.  
  203. example: httrack www.someweb.com/bob/bobby.html --spider -P proxy.myhost.com:8080
  204. runs the spider on www.someweb.com/bob/bobby.html using a proxy
  205.  
  206. example: httrack --update
  207. updates a mirror in the current folder
  208.  
  209. example: httrack
  210. will bring you to the interactive mode
  211.  
  212. example: httrack --continue
  213. continues a mirror in the current folder
  214.  
  215. HTTrack version 3.23+swf (compiled Mar  8 2003)
  216. Copyright (C) Xavier Roche and other contributors
  217.